STAC Collection by ID

This endpoint allows you to retrieve detailed metadata for a specific STAC Collection using its unique identifier. In this case, we will retrieve detailed metadata for Blacksky.

Each collection groups related geospatial data items (e.g., by sensor or provider) and provides information about spatial/temporal coverage, licensing, associated assets, and links to related endpoints.

Endpoint

GET /public/stac/collections/{collectionId}

Replace {collectionId} with the actual ID of the collection you want to query.

Include the following header:

x-api-key: YOUR_API_KEY

Example Request (cURL)

curl -H "x-api-key: YOUR_API_KEY" "https://giq.ae/public/stac/collections/d98629ef-58c5-9af8-714c-ac86b03fba66"

Example Response (Sample):

{
  "id": "d98629ef-58c5-9af8-714c-ac86b03fba66",
  "type": "Collection",
  "title": "BlackSky",
  "description": "Multispectral imagery from BlackSky",
  "license": "proprietary",
  "extent": {
    "spatial": {
      "bbox": [[-180.0, -90.0, 180.0, 90.0]]
    },
    "temporal": {
      "interval": [["2024-01-01T00:00:00Z", null]]
    }
  },
  "keywords": ["blacksky", "multispectral"],
  "stac_version": "1.0.0",
  "links": [
    {
      "rel": "self",
      "href": "https://giq.ae/public/stac/collections/d98629ef-58c5-9af8-714c-ac86b03fba66",
      "type": "application/json",
      "title": "This Collection"
    },
    {
      "rel": "items",
      "href": "https://giq.ae/public/stac/collections/d98629ef-58c5-9af8-714c-ac86b03fba66/items",
      "type": "application/geo+json",
      "title": "Collection Items"
    },
    {
      "rel": "root",
      "href": "https://giq.ae/public/stac/",
      "type": "application/json",
      "title": "Root Catalog"
    }
  ],
  "assets": {
    "thumbnail": {
      "href": "https://i.imghippo.com/files/abCdEfG.png",
      "type": "image/png",
      "roles": ["thumbnail"],
      "title": "Preview Image"
    }
  }
}

Response Overview

The response returns metadata for a single STAC Collection, including:

• Unique ID and title
• Description and licensing info
• Spatial and temporal extent
• Collection-specific assets
• Navigational links to STAC Items and root catalog

Response Fields

Field	Description	Example
id	Unique identifier of the collection	d98629ef-58c5-9af8-714c-ac86b03fba66
type	STAC object type	Collection
title	Human-readable name of the collection	BlackSky
description	Description of the collection	Multispectral imagery from BlackSky
license	Licensing information for the data	proprietary
extent	Spatial/temporal coverage of the collection	bbox, interval
keywords	Optional tags or labels	["blacksky", "multispectral"]
stac_version	STAC specification version used	1.0.0

Response Links

Rel	Description	URL
self	Link to this specific collection	/public/stac/collections/{collectionId}
items	STAC Items contained in the collection	/public/stac/collections/{collectionId}/items
root	Link to the STAC root catalog	/public/stac/

Assets

Key	Description	Type
thumbnail	A preview image of the collection	image/png

Use Cases

• Display collection-level metadata (e.g., sensor, provider)
• Build image search filters using spatial and temporal extents
• Navigate to items associated with the selected collection
• Access thumbnails for visualization in dashboards or reports